# 2-点击上报
# 简介
该文档指导开发者在对接AdsConflux网盟平台时,如何使用Tracking Link 进行点击上报。
# 对接说明
Tracking Link 获取
- 拉取Offer API后,Offer返回实体中 "tracking_link"
Tracking Link 上报
- 上报时机: 推荐上报时机为用户点击广告,跳转Google Play Store时
- 上报内容: 仅需替换{}中的宏,其他信息供AdsConflux核对信息用,开发者请勿修改
- 上报形式: server to server (s2s) 上报
- 注意事项: 部分参数在宏替换之后的值可能存在空格,上报前需进行encode编码
Tracking Link 示例
- 原始Tracking Link
http://api.rethinkad.com/moonlight/v4?value=5146ea64xxx&click_id={click_id}&affiliate_id={affiliate_id}&idfa={idfa}&gaid={gaid}&imei={imei}&android_id={android_id}&mac={mac}&oaid={oaid}&ua={ua}&os_version={os_version}&device_model={device_model}&ip={ip}&country_code={country_code}&ext={ext}
- 替换后Tracking Link(以非华为手机安卓为例)
http://api.rethinkad.com/moonlight/v4?value=5146ea64xxx&click_id=4948d389-88a5-f63b-49b7-ff4831b5e21b&affiliate_id=YFQH&idfa={idfa}&gaid=d49bad8e-9fbf-442f-a5ee-87beb3492d10&imei={imei}&android_id={android_id}&mac={mac}&oaid={oaid}&ua=Dalvik/2.1.0%20(Linux;%20U;%20Android%206.0;%20ZTE%20BA520%20Build/MRA58K)&os_version={os_version}&device_model={device_model}&ip=101.72.203.33&country_code=IN&ext={ext}
Tracking Link 参数说明
分类 | 参数名 | 类型 | 描述 | 是否必填 |
---|---|---|---|---|
通用信息 | value | string | 自带信息,可为空,无需开发者替换,请勿修改该值 | N |
affiliate_id | string | 渠道标识,从AM处获取 | Y | |
channel | string | 渠道信息,取值:gp、other | N | |
设备信息 | imei | string | Android设备的设备标识 | |
android_id | string | Android设备的设备标识 | ||
mac | string | 设备MAC地址,以MAC进行归因的Offer必传。注:若存在该类offer,投放前运营会单独与开发者沟通 | ||
uagent | string | 设备User-Agent | Y | |
os_platform | string | 系统平台(ios/android),示例:android | ||
os_version | string | 操作系统版本,示例:3.0 | ||
device_model | string | 设备型号,示例:vivo 1901 | ||
用户信息 | gaid | string | Google广告平台的用户标识 | Y |
idfa | string | iOS设备的设备标识,iOS必传 | ||
oaid | string | 若用户使用华为手机,则gaid不存在,此时oaid必传 | ||
ip | string | 设备网络IP地址,开发者服务器端需要获取APP客户端外网IP并填入此字段,而非客户端本地获取的内网IP | Y | |
country_code | string | ISO 3166-1 国际标准二位字母代码 (alpha-2),示例:CA、US。 country_code与ip需至少上报一个,建议二者均上报 | ||
ext | 拓展个性化参数,最长100字符 | |||
归因信息 | click_id | string | 开发者需为每次点击上报生成一个不重复的clickid,最长150个字符。若上报为空或者上报重复,则postback无法正确找到对应的上报点击,影响收入统计 | Y |
pkg_name | string | offer的应用包名 | N | |
event | string | show - 展示 click - 点击 startDownload - 开始下载 download - 下载结束 startInstall - 开始安装 install-安装 (需按照当前枚举值进行替换,区分大小写) | N |
← 1-Offer API 3-回传对接 →